package com.ruoyi.mall.common.mapper;

import com.ruoyi.mall.common.domain.DtsRegion;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 行政区域Mapper接口
 *
 * @author ruoyi
 * @date 2025-02-15
 */
@Mapper
public interface DtsRegionMapper
{
    /**
     * 查询行政区域
     *
     * @param id 行政区域主键
     * @return 行政区域
     */
    public DtsRegion selectDtsRegionById(Long id);

    /**
     * 查询行政区域列表
     *
     * @param dtsRegion 行政区域
     * @return 行政区域集合
     */
    public List<DtsRegion> selectDtsRegionList(DtsRegion dtsRegion);

    /**
     * 新增行政区域
     *
     * @param dtsRegion 行政区域
     * @return 结果
     */
    public int insertDtsRegion(DtsRegion dtsRegion);

    /**
     * 修改行政区域
     *
     * @param dtsRegion 行政区域
     * @return 结果
     */
    public int updateDtsRegion(DtsRegion dtsRegion);

    /**
     * 删除行政区域
     *
     * @param id 行政区域主键
     * @return 结果
     */
    public int deleteDtsRegionById(Long id);

    /**
     * 批量删除行政区域
     *
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteDtsRegionByIds(Long[] ids);

    // 根据类型获取区域列表，不传pid时获取顶层（省）数据
    List<DtsRegion> selectRegionByType(@Param("type") Integer type);
    // 根据父级ID和类型获取子区域列表，用于获取市、区数据
    List<DtsRegion> selectRegionByPidAndType(@Param("pid") Long pid, @Param("type") Integer type);
}
